调用流程
- 调用
/openapi/v3/maps/schedule-resources/list,从 maps 和 workModes 中取得机器人实际支持的地图资源与任务工作模式说明中定义的工作模式。
- 调用本接口创建排班。成功响应的
data 为排班服务返回的操作结果;本接口不会直接返回 planUuid。
- 调用
/openapi/v3/schedules/plans/pre-tasks/day/list 查询排班日期,并从 data.preTasks[].planUuid 取得后续修改、删除或详情查询所需的 planUuid。
注意事项
- 写接口的
planExecuteType 使用整数:1 为定时任务,2 为定量任务;查询接口分别返回字符串 TIMED_SCHEDULING_TASK、QUANTITATIVE_SCH_TASK。
planRepeatType=0 表示单次任务;planRepeatType=2 表示每周重复,此时 planRepeatWeekly 必填且不能为空。星期值 0 至 6 分别表示周日至周六。
- 时间格式为
HH:mm(24 小时制)。开始日期不能早于当前日期;若为当天,开始时间也必须晚于当前时间。定时任务必须传非空 planStopTime;定量任务可以省略,服务按开始时间后 1 分钟处理。显式传入的结束时间必须晚于开始时间,不支持跨午夜。
siteMode=0 时不要传 siteId;siteMode=1 时必须传 siteId。
mapId 使用地图列表接口返回的 mapId。mapResourceList 每项只要求 mapId、mapResourceId、mapResourceType。
workMode 各字段必须参考资源查询接口的实际 workModes,字段含义详见任务工作模式说明。若仅凭 mode 不能唯一匹配配置,请补充 subType、type 或 strength;省略 strength 时使用默认强度。